docs: avoid ambiguous return tags

diff --git a/gtk/deprecated/gtkstyle.h b/gtk/deprecated/gtkstyle.h
index d5bf9d7b3439ccd8923dfdb55374118165f2e2d1..4239e674e962d40e5faa11771346283c6bdbbffd 100644 (file)
--- a/gtk/deprecated/gtkstyle.h
+++ b/gtk/deprecated/gtkstyle.h
@@ -55,7 +55,7 @@ typedef struct _GtkRcProperty  GtkRcProperty;
  * GTK_STYLE_ATTACHED:
  * @style: a #GtkStyle.
  *
- * Returns whether the style is attached to a window.
+ * Returns: whether the style is attached to a window.
  */
 #define GTK_STYLE_ATTACHED(style)       (GTK_STYLE (style)->attach_count > 0)
 

diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c
index 96261847652950c4ccc657f676ee301f2bb366a6..1289f164cdc058f2ffa06ece3091b7c87fd73c04 100644 (file)
--- a/gtk/gtkheaderbar.c
+++ b/gtk/gtkheaderbar.c
@@ -2043,7 +2043,7 @@ gtk_header_bar_set_has_subtitle (GtkHeaderBar *bar,
  * gtk_header_bar_get_has_subtitle:
  * @bar: a #GtkHeaderBar
  *
- * Returns whether the header bar reserves space
+ * Returns: %TRUE if the header bar reserves space
  * for a subtitle.
  *
  * Since: 3.12

diff --git a/gtk/gtkicontheme.h b/gtk/gtkicontheme.h
index cb1368af44caa0eafae69ee4fec5be2908b70bcc..6ae42b515863527d297d91eef4fd645a24ae1ff7 100644 (file)
--- a/gtk/gtkicontheme.h
+++ b/gtk/gtkicontheme.h
@@ -111,7 +111,7 @@ struct _GtkIconThemeClass
  * @GTK_ICON_LOOKUP_GENERIC_FALLBACK: Try to shorten icon name at '-'
  *   characters before looking at inherited themes. For more general
  *   fallback, see gtk_icon_theme_choose_icon(). Since 2.12.
- * @GTK_ICON_LOOKUP_FORCE_SIZE: Always return the icon scaled to the
+ * @GTK_ICON_LOOKUP_FORCE_SIZE: Always get the icon scaled to the
  *   requested size. Since 2.14.
  * 
  * Used to specify options for gtk_icon_theme_lookup_icon()

diff --git a/gtk/gtkmenutrackeritem.c b/gtk/gtkmenutrackeritem.c
index ddcbc0bfc681d4bbdc2fbc4025a1f44cb2cdfd24..d944e9666b88643edc34a483d90b9f29f981d2e9 100644 (file)
--- a/gtk/gtkmenutrackeritem.c
+++ b/gtk/gtkmenutrackeritem.c
@@ -546,7 +546,7 @@ _gtk_menu_tracker_item_get_observable (GtkMenuTrackerItem *self)
  * gtk_menu_tracker_item_get_is_separator:
  * @self: A #GtkMenuTrackerItem instance
  *
- * Returns whether the menu item is a separator. If so, only
+ * Returns: whether the menu item is a separator. If so, only
  * certain properties may need to be obeyed. See the documentation
  * for #GtkMenuTrackerItem.
  */
@@ -560,7 +560,7 @@ gtk_menu_tracker_item_get_is_separator (GtkMenuTrackerItem *self)
  * gtk_menu_tracker_item_get_has_submenu:
  * @self: A #GtkMenuTrackerItem instance
  *
- * Returns whether the menu item has a submenu. If so, only
+ * Returns: whether the menu item has a submenu. If so, only
  * certain properties may need to be obeyed. See the documentation
  * for #GtkMenuTrackerItem.
  */